大麦家礼品代发API

# 获取面单(智能)

接口地址： http://www.damaijia168.com/vv/external/taoForSurfaceSingleZn

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数 类型 必选 值 示例
Authorization string 是 授权 access_token 1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

参数 类型 必选 描述
sellerNick string 是 掌柜号
shopCode string 是 菜鸟 token
senderAddress string 是 发货详细地址
orderNo string 是 订单号
goodsInfoList string 是 礼品信息
----goodsCount string 是 礼品数量
----goodsId string 是 礼品 id
----goodsWeight string 是 重量
----goodsName string 是 礼品名称
senderDistrict string 是 发货区县
senderProvince string 是 发货省
senderCity string 是 发货市
templateUrl string 是 模板地址
senderPhone string 是 发货人号码
senderName string 是 发货人姓名
wpCode string 是 YTO 快递编号

# 请求示例

{
  "sellerNick": "*****店",
  "orderNo": "1******1",
  "senderProvince": "广东省",
  "senderCity": "**市",
  "senderDistrict": "**区",
  "senderAddress": "测试收货地址",
  "senderName": "test001",
  "senderPhone": "18*****66",
  "templateUrl": "http://cloud****plate/standa****659/40",
  "shopCode": "YzA3****iRmpCZw==",
  "wpCode": "STO",
  "goodsInfoList": [
    {
      "goodsCount": 1,
      "goodsId": 1,
      "goodsWeight": "0.01",
      "goodsName": "***"
    }
  ]
}

# 请求代码示例

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/taoForSurfaceSingleZn' --header 'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx' --header 'Content-Type: application/json' --data-raw '{
  "sellerNick": "*****店",
  "orderNo": "1******1",
  "senderProvince": "广东省",
  "senderCity": "**市",
  "senderDistrict": "**区",
  "senderAddress": "测试收货地址",
  "senderName": "test001",
  "senderPhone": "18*****66",
  "templateUrl": "http://cloud****plate/standa****659/40",
  "shopCode": "YzA3****iRmpCZw==",
  "wpCode": "STO",
  "goodsInfoList": [
    {
      "goodsCount": 1,
      "goodsId": 1,
      "goodsWeight": "0.01",
      "goodsName": "***"
    }
  ]
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/taoForSurfaceSingleZn',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "sellerNick": "*****店",
  "orderNo": "1******1",
  "senderProvince": "广东省",
  "senderCity": "**市",
  "senderDistrict": "**区",
  "senderAddress": "测试收货地址",
  "senderName": "test001",
  "senderPhone": "18*****66",
  "templateUrl": "http://cloud****plate/standa****659/40",
  "shopCode": "YzA3****iRmpCZw==",
  "wpCode": "STO",
  "goodsInfoList": [
    {
      "goodsCount": 1,
      "goodsId": 1,
      "goodsWeight": "0.01",
      "goodsName": "***"
    }
  ]
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n  \"sellerNick\": \"*****店\",\r\n  \"orderNo\": \"1******1\",\r\n  \"senderProvince\": \"广东省\",\r\n  \"senderCity\": \"**市\",\r\n  \"senderDistrict\": \"**区\",\r\n  \"senderAddress\": \"测试收货地址\",\r\n  \"senderName\": \"test001\",\r\n  \"senderPhone\": \"18*****66\",\r\n  \"templateUrl\": \"http://cloud****plate/standa****659/40\",\r\n  \"shopCode\": \"YzA3****iRmpCZw==\",\r\n  \"wpCode\": \"STO\",\r\n  \"goodsInfoList\": [\r\n    {\r\n      \"goodsCount\": 1,\r\n      \"goodsId\": 1,\r\n      \"goodsWeight\": \"0.01\",\r\n      \"goodsName\": \"***\"\r\n    }\r\n  ]\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/taoForSurfaceSingleZn")
  .method("POST", body)
  .addHeader("Authorization", "1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Python请求代码示例

import requests
import json

url = "http://www.damaijia168.com/vv/external/taoForSurfaceSingleZn"

payload = json.dumps({
  "sellerNick": "*****店",
  "orderNo": "1******1",
  "senderProvince": "广东省",
  "senderCity": "**市",
  "senderDistrict": "**区",
  "senderAddress": "测试收货地址",
  "senderName": "test001",
  "senderPhone": "18*****66",
  "templateUrl": "http://cloud****plate/standa****659/40",
  "shopCode": "YzA3****iRmpCZw==",
  "wpCode": "STO",
  "goodsInfoList": [
    {
      "goodsCount": 1,
      "goodsId": 1,
      "goodsWeight": "0.01",
      "goodsName": "***"
    }
  ]
})
headers = {
  'Authorization': '1798c6aadec33d1bc2f5b707f1049aefexxxx',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

# 响应参数

参数 类型 描述
data object 返回数据
----orderNo string 订单号
----printData string 打印数据
----waybillNo string 面单号
----amount int 消耗点券
status int 状态码，0为成功

# 返回数据

{
  "data":{
        "orderNo": "1**********3",
        "printData": "打印成功",
        "waybillNo":"4**********0"
    },
  "status": 0
}

# 错误码

状态码(status)） 错误说明
1003 用户不存在
132 请求格式必须为JSON
422 参数列表不合法，在err中会给出提示
200 认证失败
202 商品id不合法
203 仓库id不合法
228 订单来源不合法
217 创建订单失败
212 包裹id不合法
209 账户余额不足

← 7_获取面单[非智能] →